Port BUSACCESS - SOCKETADAPTOR¶
Active and passive communication with AUTOSAR PDUs transmitted via SocketAdaptor.
此端口要求安装 PCAP 驱动。
Stimulation¶
此端口不具备激励能力。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Active mode |
☐ |
bool |
Whether the port is also allowed to send network packets. If unset, the port can only passively receive packets. |
||
物理层 ❲网络访问❳ |
|||||
网络接口卡 |
[ONLINE] |
string |
用于接收网络报文的网卡或网络适配器 |
||
MAC 地址 ❲客户端❳ |
Active mode is enabled |
‘02:00:4C:4F:4F:50’ |
string |
字符串(格式:02:00:4C:4F:4F:50);若应使用适配器的 MAC 地址,则为 ‘default’ |
|
VLAN Settings ❲IEEE 802.1Q❳ |
|||||
VLAN mode |
disable |
[disable, single tagging] |
string |
如果应使用数据库中的 VLAN ID,则设为 ‘auto’;如果不应使用 VLAN,则设为 ‘disable’;如果应指定固定的 VLAN ID,则设为 ‘single tagging’ |
|
VLAN id |
VLAN 模式:‘single tagging’ |
0 |
int |
如果传入的数据包带有 VLAN 标签,则会对其进行过滤,只有带有该 VLAN ID 的数据包才能通过。不带任何 VLAN 标签的传入数据包也会通过过滤器。 |
|
Logger Protocol Settings |
Active mode is disabled |
||||
Logger protocol |
Active mode is disabled |
[, ASAM CMP, PLP/TECMP] |
string |
Use a logger protocol such as ASAM CMP. Ethernet frames contained in the logger messages are then extracted. |
|
Device and Stream IDs |
Active mode is disabled » Logger protocol: ‘ASAM CMP’ |
string |
Identifiers of the devices and streams as a list of tuples, each consisting of device ID and stream ID, e.g.: (1,2),(3,4). Leave empty if no filtering based on device and stream ID is needed. |
||
Interface IDs |
Active mode is disabled » Logger protocol: ‘ASAM CMP’ |
string |
Identifiers of the interfaces: empty if no filtering based on interface IDs is required; several can be separated by commas. |
||
Device IDs / Probe IDs |
Active mode is disabled » Logger protocol: ‘PLP/TECMP’ |
string |
Identifiers of the devices / probes: empty if no filtering based on device / probe IDs is required; several can be separated by commas. |
||
Interface IDs / Bus Spec IDs |
Active mode is disabled » Logger protocol: ‘PLP/TECMP’ |
string |
Identifiers of the interfaces / bus specs: empty if no filtering based on interface / bus spec IDs is required; several can be separated by commas. |
||
Outer VLAN mode |
Active mode is disabled |
disable |
[disable, single tagging, single tagging (any ID)] |
string |
If set to ‘single tagging’, take an additional IEEE 802.1Q tag outside the logger protocol into account and filter by the specified VLAN id; or if set to ‘single tagging (any ID)’, the tag itself must be present but the VLAN id is not relevant. |
Outer VLAN id |
Active mode is disabled » Outer VLAN mode: ‘single tagging’ |
0 |
int |
Filter incoming packets by this VLAN id, so only packets with a matching VLAN id will pass. |
|
IP Settings |
Active mode is enabled |
||||
IP version |
Active mode is enabled |
IPv4 |
[IPv4, IPv6] |
string |
所用 IP 版本的选择 |
IP 地址 ❲客户端❳ |
Active mode is enabled |
string |
用作客户端的 IP 地址。它必须与被测设备的 IP 地址位于同一子网,且不得等于其他参与者的 IP 地址,也不得等于操作系统分配给所选网络接口的 IP 地址。 |
||
Subnet mask / prefix length |
Active mode is enabled |
‘default’ |
string |
对于 IPv4 地址,可以给出子网掩码或前缀长度(格式:‘255.255.255.0’ 或 ‘24’)。‘default’ 使用该 IP 地址(客户端)所属网络类的默认子网掩码。 对于 IPv6,只接受前缀长度,且不支持值 ‘default’。 |
|
网关地址 |
Active mode is enabled |
string |
网关的 IP 地址,通过该网关可以访问本地子网之外的主机。如果不需要网关,请留空 |
||
UDP Settings |
Active mode is enabled |
||||
Port number ❲client❳ |
Active mode is enabled |
int |
Local UDP port for sending and receiving |
||
Socket-Adaptor Settings |
Active mode is enabled |
||||
Remote IP address |
Active mode is enabled |
string |
IP address to which the socket adapter messages should be sent - e.g. a multicast address |
||
Remote port number |
Active mode is enabled |
int |
UDP port to which socket-adapter messages should be sent |
||
自动 E2E 计算的占位符值 |
Active mode is enabled |
int |
只要为 E2E 信号(例如 CRC)指定了该值,ecu.test 在发送时就会自动将其替换为计算出的正确值。该选项的用途是允许发送任意固定值(与本处选择的值不同)。将该选项留空会完全禁用此功能。更多信息请参见文档 Tool categories - Automatic E2E calculation |
Jobs 🛈¶
ClearFrame¶
清除指定帧的接收缓冲区
Note: ClearFrame can be replaced by the job ClearPdu
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
FrameId |
int |
Frame ID |
|||
isExtended |
None |
[False, True] |
bool |
地址格式:True 表示 29 位,False 表示 11 位,None 使用测试台架配置中的“Mode”设置 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
ByteStream |
ByteStream |
ClearPdu¶
Clears the input buffer of the specified socket adapter PDU
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
HeaderId |
int |
Socket adapter PDU header ID |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
ByteStream |
Read Socket Adapter PDU as ByteStream. |
DeregisterFrameForInbox¶
注销一个流式传输到收件箱的帧
Note: DeregisterFrameForInbox can be replaced by the job DeregisterPduForInbox
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
FrameId |
int |
Frame ID |
|||
Inbox |
object |
现有收件箱 |
|||
isExtended |
None |
[False, True] |
bool |
地址格式:True 表示 29 位,False 表示 11 位,None 使用测试台架配置中的“Mode”设置 |
DeregisterPduForInbox¶
Deregisters a socket adapter PDU streamed to the inbox
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
HeaderId |
int |
Socket adapter PDU header ID |
|||
Inbox |
object |
现有收件箱 |
DisableSendPduCyclic¶
Disable cyclic sending of a socket adapter PDU with specified header ID
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
HeaderId |
int |
Socket adapter PDU header ID |
GetFirstValue¶
返回自 test case 启动以来收到的信号的第一个值。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
FrameName |
string |
Frame name |
|||
NodeName |
string |
电子控制单元的名称 |
|||
RawValue |
False |
[False, True] |
bool |
如果为 ‘True’,则返回原始值。 |
|
Reset |
False |
[False, True] |
bool |
若为 ‘True’,则第一个接收到的值在被读取后将被删除 |
|
SignalName |
string |
信号名称 |
GetLastReceptionTimestamp¶
获取最后一次接收的时间戳(以秒为单位)
InitFrame¶
注册报文 ID 以供后续使用,例如 ReadFrame
Note: InitFrame can be replaced by the job InitPdu
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
FrameId |
int |
Frame ID |
|||
isExtended |
None |
[False, True] |
bool |
地址格式:True 表示 29 位,False 表示 11 位,None 使用测试台架配置中的“Mode”设置 |
InitPdu¶
注册头 ID,并在被动模式下注册连接参数,供后续使用,例如供 ReadPdu 使用
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
HeaderId |
int |
Socket adapter PDU header ID |
|||
Ip |
string |
IP 地址(被动模式下必需) |
|||
IsSource |
False |
[False, True] |
bool |
PDU 的连接参数是否指定源(被动模式下必需)。 |
|
Port |
int |
端口(被动模式下必需) |
ReadFrame¶
读取指定的帧 ID(此前请先使用 InitFrame!)
Note: ReadFrame can be replaced by the job ReadPdu
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
doDelete |
False |
[False, True] |
bool |
若为 “True”,则在读取后删除该帧 |
|
FrameId |
int |
Frame ID |
|||
isExtended |
None |
[False, True] |
bool |
地址格式:True 表示 29 位,False 表示 11 位,None 使用测试台架配置中的“Mode”设置 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
ByteStream |
ByteStream |
ReadFrameEx¶
读取指定的帧 ID(此前请先使用 InitFrame!)
Note: ReadFrameEx can be replaced by the job ReadPdu (returning a read frame as frame object is no longer supported for SocketAdaptor)
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
doDelete |
False |
[False, True] |
bool |
若为 “True”,则在读取后删除该帧 |
|
FrameId |
int |
Frame ID |
|||
isExtended |
None |
[False, True] |
bool |
地址格式:True 表示 29 位,False 表示 11 位,None 使用测试台架配置中的“Mode”设置 |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
object |
CanFrame |
ReadPdu¶
Reads a socket adapter PDU
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
DoDelete |
False |
[False, True] |
bool |
Flag for deleting the last message: True: delete, False: do not delete (default) |
|
HeaderId |
int |
Socket adapter PDU header ID |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
ByteStream |
Read Socket Adapter PDU as ByteStream. |
RegisterFrameForInbox¶
注册一个帧,以便将其流式传输到 Inbox。
Note: RegisterFrameForInbox can be replaced by the job RegisterPduForInbox
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
FrameId |
int |
Frame ID |
|||
Inbox |
object |
现有收件箱 |
|||
isExtended |
None |
[False, True] |
bool |
地址格式:True 表示 29 位,False 表示 11 位,None 使用测试台架配置中的“Mode”设置 |
|
saveAsCanFrame |
False |
[False, True] |
bool |
如果为 True,则该帧保存为 CanFrame 对象,否则保存为 ByteStream |
RegisterPduForInbox¶
Registers a socket adapter PDU to be streamed into an inbox.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
HeaderId |
int |
Socket adapter PDU header ID |
|||
Inbox |
object |
现有收件箱 |
ResetFirstValue¶
清除给定信号的第一个已接收值
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
FrameName |
string |
Frame name |
|||
NodeName |
string |
电子控制单元的名称 |
|||
SignalName |
string |
信号名称 |
SendPdu¶
Sends a socket adapter PDU to the specified address
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
DestinationIp |
string |
Target IP address |
|||
DestinationPort |
0 |
int |
Destination port |
||
HeaderId |
int |
Header ID of the socket adapter PDU if it is to be sent with a header |
|||
Payload |
ByteStream |
Payload to be sent as a ByteStream. |
SendPduCyclic¶
Cyclic sending of a socket adapter PDU with specified header ID and data
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Count |
int |
发送重复次数 |
|||
HeaderId |
int |
Socket adapter PDU header ID |
|||
Interval |
int |
循环时间,单位为 ms |
|||
Payload |
ByteStream |
Payload to be sent as a ByteStream. |